home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 023a / 2act20.zip / 2ACT.DOC < prev    next >
Text File  |  1991-10-05  |  45KB  |  1,028 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                              Second Account 
  9.  
  10.                              copyright 1991 
  11.                            by Dalaye Gabriel 
  12.  
  13.  
  14.                     Polymath One BBS, of Trenton, NJ
  15.                     (609) 392-5953    CIS 70017,1667
  16.                                           
  17.  
  18.  Seamless interface to allow leaving PCBoard, loading a second copy of
  19.  PCBoard, with the proper User info being loaded without User input.
  20.  Intended to allow a Sysop to use a second Users file for separate
  21.  acount access, including the use of aliases, and even a separate
  22.  Cnames file to allow different conference access, and any other
  23.  PCBoard configuration files (Tcan, Pwrd, Upsec, etc.).
  24.  
  25.  This is expected to be used only with PCBoard versions of 14.0 and
  26.  higher.  Future versions may require the use of PCBoard versions
  27.  of 14.5 or newer.
  28.  
  29.  
  30.  
  31.  
  32. Introduction:
  33.  
  34.     This text makes reference to all in the male gender for the sake
  35.  of brevity, but in all cases this refers to both male and female.
  36.  
  37.     This text is not complete on setting up doors, or a copy of PCBoard.
  38.  It is assumed you have purchased PCBoard and have all needed docs on
  39.  proper BAT files, and the use of PCBSetup.exe, MKTXT145.exe and other
  40.  required support files from Clark Development.
  41.  
  42.     This program requires access to BRUN45.EXE, the "patched" version,
  43.  so your users are not disconnected. 
  44.  
  45.  
  46.  Method:
  47.  
  48.  Read PCBoard.Sys file, creating a new PCBoard.Sys in new sub-dir with
  49.  all changes needed to properly access a second (and different) USERS
  50.  file than the first PCBoard.Sys refers to.  This requires accessing the
  51.  following files from area leaving: PCBoard.Sys, Users
  52.  And accessing the following files for the new PCBoard area: PCBoard.Sys,
  53.  Users, Pwrd
  54.  It will write a new BAT file, 2ACT$.BAT called from the first
  55.  account (from the PCB written DOOR.BAT)
  56.  The user is always placed in Conference 0 upon entry via 2ACT.
  57.  All major functions occurring during 2ACT processing will be written to 
  58.  the specified CALLERS file.
  59.  
  60.  
  61.  
  62.  
  63.  Features:
  64.  
  65.  ALL PCBOARD INTEGRITY MAINTAINED! PCboard security is responsible
  66.  for virtually all Sysop control over Second Account access
  67.  
  68.  Carrier Loss, Modem Speed, Networking, Inactivity, Security Levels
  69.  etc ALL are limited only by PCBoard and the Sysop - NOT this program
  70.  
  71.  Fast, seamless, with NO interaction required by the User after the
  72.  first time ever in Second Account!
  73.  
  74.  Unlimited Conferences and access control (actual possibilities by
  75.  the Sysop are VIRTUALLY UNLIMITED - No computer has yet been built
  76.  that can be configured for all of them at one time!) - the only
  77.  real limit is Sysop imagination.
  78.  
  79.  NO MENUS OR NOTICES DISPLAYED TO USER (except 1 short sentence at
  80.  run time - not even that, in some instances) - SEAMLESS!!
  81.  
  82.  Sysop Alias? No problem!
  83.  
  84.  NO User prompting for Alias!  Seamlessly loaded by Second Account!
  85.  
  86.  Allows sharing of 100% of the PCBoard files (except PCBoard.sys)
  87.  with first account if so desired
  88.  
  89.  Allows Second Account to load a separate Users file, separate
  90.  PCBoard.dat, Cnames, Pwrd, PCBText, BRDM (and anything else!) if
  91.  desired to allow different conferences, file access, menus, aliases,
  92.  security levels, files ratios, and anything else you can dream up.
  93.  
  94.  Separate maintenance program for LOCKing out, or ALLOWing (or
  95.  disALLOWing) individual Users to the Second Account
  96.  
  97.  All maintenance to actual second account Users via PCBoard only
  98.  
  99.  Sysop record 1 security
  100.  
  101.  Can be configured as entirely INVISIBLE to Users not-Sysop defined
  102.  
  103.  Fully functional while Unregistered, just not seamless nor invisible
  104.  
  105.  
  106.  License to Use and Distribute:
  107.  
  108.  PCBoard is a registered trademark of Clark Development Corp, and all
  109.  reference to such is here to identify their software, and the proper
  110.  expected use of Second Account in conjunction with such software.
  111.  
  112.  All programs released relative to Second Account, including, but
  113.  not limited to 2ACT.EXE, 2ACTCVT.EXE, 2ACTADD.EXE, 2ACTSM.EXE are
  114.  copyrighted by Dalaye Gabriel, and all rights are reserved by the author.
  115.  No alterations may be made in any manner to the distributed group of files 
  116.  composing the Second Account package except by the author, either 
  117.  individually or as a whole.
  118.  
  119.  Anyone has the right to distribute unaltered copies of the entire
  120.  Second Account package as a whole, without further permission.
  121.  
  122.  The Second Account package is released without a warranty for any specific 
  123.  purpose whatsoever, and anyone using any portion of this software package 
  124.  has no claim upon the author for damages, and uses such software at his/her 
  125.  own risk.
  126.  
  127.  All software is distributed freely through Bulletin Board Systems and
  128.  no person or company is allowed to charge any fee for distributing
  129.  any portion of the Second Account package without separate license
  130.  from the author.  Under US copyright law, full compensation, including
  131.  all legal fees incurred, will be recovered from violators of this license.
  132.  
  133.  The only acceptable fee under this license is any amount required for
  134.  only diskette and postage costs when distributed in such manner by
  135.  any not-for-profit group, whether a computer User's Group, or a
  136.  public Bulletin Board System.  No compensation for service or labor
  137.  to provide diskette copies is allowed under this license.
  138.  
  139.  No use is allowed of Second Account on any system for a period of more
  140.  than 45 days of evaluation without registration.  It is distributed
  141.  under the "shareware" concept, to allow a proper trial period before
  142.  registering, and is not free software, nor in the public domain.
  143.  
  144.  
  145.  
  146.  
  147.  Why Second Account?
  148.  
  149.     My BBS has considerable adult and non-adult traffic of Users, and
  150.  I found it best to entirely segregate the two areas.  I'm aware that
  151.  many merely open a second BBS.  Meanwhile, any users visiting the
  152.  adult conferences wish to use aliases to leave messages.  I tried the
  153.  another alternative, but was I wasn't happy with its operation, or the
  154.  idea I could do little to control access as I chose to.
  155.  
  156.     Meanwhile, I found it nice to segregate credits of Uploads/Downloads
  157.  to a users record from the 2 areas, and seriously considered doing
  158.  what so many people eventually do: open a second, adults-only BBS,
  159.  leaving the first alone.  I considered this unacceptable, as it
  160.  would mean more work for the user to visit both, and tie up all my
  161.  equipment separately, stop node chats, and other such.
  162.  
  163.     So, I found it best to create a new sub-directory, one for each
  164.  node on the system, and setup a separate BBS entirely, but, to be
  165.  accessed as a door from the first BBS.  This wastes very little disk
  166.  space, as most files can be shared with the first.
  167.  
  168.     The problem with initially calling the second board from the first?
  169.  Users hated the idea of having to logon a second time, and I hated the
  170.  maintenance headache of seeing who opened a second account in the
  171.  second board loaded, as, when it prompts for a name, more than 1 user
  172.  chose to open new additional accounts for himself.  Major headache as
  173.  the number of users grew!
  174.  
  175.  
  176.  
  177.  Solution:
  178.  
  179.     Second Account!  It lets you set up a second BBS as a door from the 
  180.  first BBS, loading all user information needed with the information you 
  181.  configure within the 2ACT.CFG file. 2ACT.CFG must be in the sub-directory 
  182.  that 2ACT is called from.
  183.   
  184.     Many users of this software will enjoy the tremendous flexibility it 
  185.  now gives a PCBoard Sysop.  The first account that users log on to the
  186.  BBS with can now be used as a "front end" to cleanly load additional
  187.  accounts, which need not share any information with the first, or share
  188.  as much as desired.  Some configurations take extremely little additional 
  189.  disk space, and allow the Sysop literally twice the possible configurations
  190.  for a single BBS as compared to the already enormous number allowed under
  191.  PCBoard!  The Sysop may choose to actually run an entirely separate BBS
  192.  as a Second Account, with no time constraints being shared, or files, and
  193.  even the Sysop responsibilities need not be shared.
  194.  
  195.     Imagine running 2 (or more!) entirely separate Bulletin Board Systems 
  196.  from the same phone line, and still maintaining the complete security of 
  197.  PCBoard!  And, the user only needs one logon per phone call!
  198.  
  199.     My BBS now runs several sub-boards in this manner, each a Private
  200.  BBS for a separate purpose.  Example:  A software author provides
  201.  support on my BBS to registered users of his software.  Prior to the
  202.  use of Second Account, the Sysop (me) had to assign certain levels and
  203.  do the maintenance of the Support Conference involved.  Now, the entire
  204.  job is under that author's control, and his registered users are placed
  205.  by him, and can freely upload, download and read messages with no
  206.  impact upon their time or status on the "normal" BBS!
  207.  
  208.  
  209.  
  210.  Security:
  211.  
  212.  Record #1 of the USERS file (second account) can only be accessed by
  213.  record #1 of first account USERS file.  In no place is the Sysop
  214.  password checked for or written by this program.  LOCK and ALLOW
  215.  features are now available, letting the Sysop run this program with
  216.  ability to LOCK anyone not entered by him, or to LOCK individual
  217.  users from access.  The ALLOW feature is similar to LOCK, but lets
  218.  the Sysop have a more polite method of not allowing a User access
  219.  to the Second Account than LOCK would be used for.  It is meant to
  220.  be used where a Sysop chooses to allow a New User to the Second
  221.  Account, but must review his status before actual access allowed.
  222.  Using LOCK and ALLOW combined with the security of PCBoard gives the
  223.  Sysop tremendous flexibility in controlling access as he sees fit.
  224.  
  225.  All normal PCBoard security remains in full force, as this program
  226.  does not supercede PCBoard, but merely allows the PCBoard security
  227.  to take over.
  228.  
  229.  Any unusual occurences are handled almost entirely by the exisiting
  230.  (and well-proven) PCBoard software.  Please read elsewhere about the
  231.  value of the "dummy PCBoard.sys" file if you have non-modem Users
  232.  on your system - this should be taken into account by any such Sysop
  233.  not using the PCBoard parameter of checking for a User's Password
  234.  upon return from a Door.  Properly setup, the loss of carrier detect
  235.  handles such situations where modems are in use.
  236.  
  237.  
  238.  
  239. New This Release:
  240.  
  241.   The word PCBoard has been dropped, and the PCB prefix has been dropped
  242.   to insure no conflict with the trademark "PCBoard" of Clark
  243.   Development, and to insure no one receives any impression that this
  244.   program is endorsed by the authors of PCBoard.
  245.  
  246.   Better documentation!
  247.  
  248.   File holds 1st Account & 2nd Account User Names, and flags to
  249.   control access to the Second Account
  250.  
  251.   Writes all important occurrences to the CALLERS file.
  252.  
  253.   Better security, including self-check.
  254.  
  255.   Automatically can add New Second Account Users for access!
  256.  
  257.   Separate maintenance program to control access to the Second Account
  258.  
  259.   Very good error-trapping capabilities
  260.  
  261.   Sysop definable messages for LOCKed out Users
  262.  
  263.   Can enter any New User in for access to the Second Account without
  264.   requiring the Sysop to do anything at all
  265.  
  266.  
  267. What's Coming in the Future?
  268.  
  269.   2ACTSM.EXE will be accessable without the use of Doorway
  270.  
  271.   More flexibility of control of User time allowances
  272.  
  273.   Ability to pass keystrokes to the loading of the Second Account
  274.  
  275.   ... and at this time any ideas of Users will be considered.
  276.  
  277.  
  278.  
  279. History:
  280.  
  281. October 5, 1991 - ver.2.0 beta release
  282.  
  283. September 25, 1991 - ver.2.0 (local beta)
  284.  A complete re-write, changes format, security, maintenance, etc
  285.  
  286. September 15, 1991 - ver.1.2 beta
  287.  Network relative fix for NEWGUY file
  288.  
  289. September 14, 1991 - ver.1.2 beta
  290.  Network fix
  291.  
  292. September 11, 1991 - ver.1.2 beta
  293.  Major typo occurred in 2 places - this is a fix.
  294.  The previous version docs showed the command line and the LOCK parameters
  295.  flip flopped in position in the .CFG file.
  296.  
  297. September 10, 1991 - ver.1.1 beta
  298.  Major change in error handling, to insure all errors are trapped properly
  299.  to be located in source code, and any errors occurring will properly exit
  300.  and reload the first account.
  301.  A locking parameter is also now expected in the PCB2ACT.CFG file, to 
  302.  prevent anyone barred from the second PCB account from entering.
  303.  
  304. Date Unknown - ver.1.0  alpha/beta
  305.  I threw together PCB2ACT real fast for use on my BBS...No regard for
  306.  error handling, control, etc.
  307.  
  308. Set-up:
  309.  
  310.     It is assumed the Second account will not share 100% of the files
  311.  with the first account, and a separate sub-directory will be used for
  312.  all files particular to each Second account (and node) in use.
  313.     If you expect to use more than one Second Account, decide all the
  314.  parameters for each carefully for getting started - the possible
  315.  layout of individual access becomes virtually limitless.  Read the
  316.  section on Applications prior to setting up for some guidelines.
  317.     These set-up procedures are for the most common, and simple, use
  318.  of PCB Second Account, which is the first defined under Applications.
  319.  
  320.     Create a sub-directory:  C:\PCB\SECOND   suggested name
  321.     Most likely, you will be sharing most parameters and files with
  322.  the first account, so copy that account's CNAMES.* and PCBOARD.DAT
  323.  file to C:\PCB\SECOND\
  324.     If only minor changes are expected in any of the account specific
  325.  files, copy those over also at this time.
  326.  
  327.     Run PCBSETUP.EXE and change the parameters for file location for
  328.  the files to be located for only this Second Account.
  329.     Expected to be: USERS, CNAMES, BRDM, PCBTEXT, TCAN
  330.     And possibly: DOWNLOAD.TXT, PWRD, UPSEC
  331.     And anything else you feel should be account specific.
  332.     If you wish to use an Alias as Sysop, place that Alias in Record
  333.  #1 of the Users file, and set the "Use Real Name?" flag to Y.
  334.      If to run under multiple nodes, create a separate sub-directory
  335.  for each node, as: C:\PCB\SECOND2  for Node 2, etc.
  336.     Copy the PCBOARD.DAT from C:\PCB\SECOND to each nodes second account
  337.  sub-directory, and run PCBSETUP to change node specific parameters.
  338.     It is assumed no other files will exist in this sub-directory other
  339.  than BAT files required for file transfer, or possibly EVENT.SYS and
  340.  such.
  341.     Copy all the 2ACT files to your C:\PCB\SECOND sub-directory.
  342.     Edit the 2ACT.CFG to relect your requirements.  If additional nodes
  343.  will be used, copy the 2ACT.CFG to nodes new sub-directory also (ie:
  344.  C:\PCB\SECOND\NODE2) and edit that copy to show the proper files
  345.  locations for that node.
  346.     Run 2ACTSM (or 2ACTCVT if upgrading from ver.1.1) to initialize the
  347.  2ACT.NAM file.  No entry required for the Sysop in this file, but you
  348.  may wish to enter a User (or many) at this time depending on your
  349.  configuration.
  350.     Edit your Doors.lst file to include 2ACT as a Door, and then place
  351.  it in your Doors Menu.
  352.     Edit the 2ACT file to use the parameters required for your system.
  353.  If multi-node, then copy it to each nodes first PCBoard directory, and
  354.  edit each to reflect what is needed to access the proper node's
  355.  sub-directory.
  356.     Done!
  357.  
  358.  
  359. Files Included in the 2ACT##.ZIP:
  360.  
  361. 2ACT.EXE     - The main Second Account program
  362. 2ACT.CFG     - Configuration file, must be edited for your system
  363. 2ACTCVT.EXE  - Program to build 2ACT.NAM from your Comment2 fields
  364.                if previously runnng an older version of 2ACT.
  365. 2ACTADD.EXE  - Program to add new users to the 2ACT.NAM file
  366.                automatically
  367. 2ACTSM.EXE   - Maintenance program for 2ACT.NAM file
  368. NOGOOD.MSG   - Message shown to User when unrecoverable error occurs
  369. NEWGUY.MSG   - Message to be displayed to a new Second Account User
  370. NOTALLOW.MSG - Message to show a User flagged as Not ALLOWed
  371. LOCKED.MSG   - Message to be shown to a LOCKed out User
  372. 2ACT         - Example of a calling BAT file to run 2ACT
  373. SECOND.BAT   - Example of BAT to reload from a Door
  374. ANYDOOR      - Example of how to run a Door from the second account,
  375.                and to properly return to the second account
  376. PCBSYS.HLD   - An "empty" PCBoard.sys file you may choose to use for
  377.                security reasons
  378.  
  379. Files that will be created by 2ACT:
  380.  
  381. 2ACT.NAM     - Stores first account & second account names, and the
  382.                lock and allow flags for each user
  383. NOGOOD.      - 0 byte file created if 2ACT cannot handle the user
  384.                for any reason not covered elsewhere
  385.                This filename can be changed by an entry in 2ACT.CFG
  386. NEWGUY.      - 0 byte file created when a user with no entry in the
  387.                2ACT.NAM file enters
  388.                This filename can be changed by an entry in 2ACT.CFG
  389.  
  390. Miscellaneous:
  391.  
  392.    It is assumed in the examples that you have a file called BOARD.BAT
  393.  that will load the first account, with all proper checks for event and
  394.  door use.
  395.  
  396.  
  397. Files Detail:
  398.  
  399. 2ACT - File to be opened as a Door by PCBoard, it must be defined
  400.          in Doors.Lst
  401.  
  402. cd\pcb\second
  403. if exist 2act$.bat del 2act$.bat
  404. if exist endpcb del endpcb
  405. if exist door.bat del door.bat
  406. if exist newguy del newguy
  407. if exist nogood del nogood
  408. c:\util\2act
  409. rem if exist newguy goto end
  410. rem if exist nogood goto end
  411. call 2act$.bat
  412. if not exist newguy goto done
  413. c:\util\2actadd
  414. :done
  415. if exist door.bat door
  416. if exist event.bat event
  417. if exist endpcb goto end
  418. second
  419. :end
  420. copy pcbsys.hld pcboard.sys
  421. c:
  422. cd\pcb
  423. board
  424.  
  425.     Notice that if 2ACT fails to properly build the BAT file to load the
  426.  second PCB account, it will definitely return to the first account.  Also,
  427.  you may want to include the line to copy a "dummy" PCBoard.sys (included)
  428.  prior to reloading the first account in case there is an error of any sort,
  429.  and the PCBoard.sys in place has Sysop access!  This insures no one gets
  430.  accidental Sysop access, which could occur if the system had a boot in the 
  431.  middle of the session.  This same situation is true of any door, or exit
  432.  to DOS, usually trusted to the DTR check.  If you have a first STARTUP.BAT
  433.  that runs after the AUTOEXEC.BAT upon boot, you may like to use such a line
  434.  to clear the 2nd account PCBoard.sys and any PCBoard.sys accessible even in
  435.  a first account where loss of carrier detect will not clear it, as, if you 
  436.  allow Local logons this is possible also.  This "empty" PCBoard.sys is
  437.  a clean alternative to checking for a User's Password upon return to
  438.  the board from a door.
  439.     Using the "dummy PCBoard.sys" is required if you allow the User to
  440.  exit the BBS from within the Second Account.  If you do not allow it,
  441.  and the User drops carrier, PCBoard will properly recycle, and reload
  442.  the first account, which will then also recycle due to carrier loss.
  443.  While this is slow, it is not insecure unless you have Users without
  444.  modem use.  You may choose to create a command called "OFF" to allow
  445.  Users to exit the BBS from the Second Account to quickly restore the
  446.  BBS online.  See the information on this command later.
  447.  
  448.     That is basically what is required in the Door calling the second
  449.  PCBoard to load.  You will have to include all the other checks used
  450.  as necessary, if you plan to open doors, run an event, etc. from the
  451.  second PCBoard loaded.
  452.  
  453.  
  454. SECOND.BAT - this file is not required unless you choose to run a door
  455.              from within the second account, and it then must be used
  456.              to reload the second account.  Notice where it is called
  457.              in the SECOND file, which is copied over to a DOOR.BAT by
  458.              PCBoard when the second account is accessed.  This means
  459.              you do have the alternative of insteading loading the
  460.              DOOR.BAT found in the first account sub-directory, but
  461.              I believe you will find this method cleaner.
  462.  
  463. if exist endpcb del endpcb
  464. if exist door.bat del door.bat
  465. c:\pcb\pcb145
  466. :done
  467. if exist door.bat door
  468. if exist event.bat event
  469. if exist endpcb goto end
  470. second
  471. :end
  472. copy pcbsys.hld pcboard.sys
  473. c:
  474. cd\pcb
  475. board
  476.  
  477.   Notice that it should appear identical to your BOARD.BAT file you
  478.   use for the first account, except that it will reload itself if the
  479.   ENDPCB file is not found.  Your BOARD.BAT should call BOARD in that
  480.   case, as the first account always reloads if no ENDPCB is found, as
  481.   both the first & second accounts then assume you are returning from
  482.   either a Door or the daily Event.
  483.  
  484.  
  485. ANYDOOR - example of a generic door loading file, PCBoard will copy the
  486.   contents to a DOOR.BAT when the ANYDOOR is called.  The ANYDOOR must
  487.   be the actual name of the Door being called listed in the DOORS.LST
  488.   file.  This example is meant to run ANYDOOR from the second account,
  489.   then return to the second account after exiting.
  490.  
  491. cd\doors
  492. mydoor
  493. c:
  494. cd\pcb\second
  495. second
  496.  
  497.   This is assuming you created the SECOND.BAT, rather than reloading
  498.   from the first account DOOR.BAT still sitting in the first account
  499.   sub-directory.
  500.  
  501.  
  502. 2ACT.NAM:
  503.  
  504.   ASCII file of 52 byte records, holds User names for 1st account
  505.   and second account, and flags for LOCK and ALLOW for each.
  506.  
  507.   Note: The following applies to the ver.2.0 file, though the first
  508.   3 records are not used by 2ACT or 2ACTSM until the 3.0 release.
  509.  
  510.   First 3 records hold User names of Users allowed to change their
  511.   logon names into Second Account for maintenance reasons - the
  512.   second half of each such entry is their password to enter 2ACT
  513.   maintenance.  The LOCK and ALLOW flags are ignored in those records,
  514.   as those Users are given the option of either maintenance or access
  515.   every time 2ACT is accessed, and those Users must have a separate
  516.   entry for alias use also - upon such User choosing to access the
  517.   second account, the record with the alias is used.
  518.  
  519.   Note: At this time, 2ACTSM.EXE can only be run locally or through
  520.   the use of DOORWAY over the modem, and does not recognize the first
  521.   three entries in any manner.
  522.  
  523.   Under Sysop maintenance, the LOCK flag can be set on/off for
  524.   any User registered in the .NAM file.  The Sysop can create a
  525.   record and LOCK any User regardless of whether he/she has a record
  526.   in the PCBoard Users file.
  527.  
  528.   This file is created when 2ACTCVT is run.  This 2ACT.NAM file MUST
  529.   be created prior to running 2ACT.  See the information on running
  530.   2ACTCVT.
  531.  
  532.  
  533. 2ACT.CFG
  534.  
  535.   This file must be located in the directory from which @ACT is called,
  536.   and contains all needed filenames and flags for 2ACT.
  537.  
  538.   Line 1 - drive, path, filename of first account PCBoard.sys
  539.   Line 2 - drive, path, filename of first account USERS file
  540.   Line 3 - drive, path, filename of 2nd account PCBoard.sys
  541.   Line 4 - drive, path, filename of 2nd account USERS file
  542.   Line 5 - drive, path, filename of 2nd account PWRD file
  543.   Line 6 - drive, path, filename of CALLERS file to log info
  544.   Line 7 - drive, path, filename to create NOGOOD file
  545.   Line 8 - drive, path, filename of message if NOGOOD created
  546.   Line 9 - drive, path, filename to create NEWGUY file
  547.  Line 10 - drive, path, filename of message if NEWGUY created
  548.  Line 11 - command to load PCBoard
  549.  Line 12 - drive, path, filename of 2ACT.NAM file
  550.  Line 13 - LOCK feature - MUST be Y, N or ALL
  551.  Line 14 - drive, path, filename of message if User LOCKed out
  552.  Line 15 - ALLOW feature - MUST be Y, N or ALL
  553.  Line 16 - drive, path, filename of message if User not ALLOWed
  554.  Line 17 - Reserved until version 3.0 - MUST be set to N
  555.  Line 18 - Reserved until version 3.0 - MUST be set to N
  556.  Line 19 - Reserved until version 3.0 - MUST be set to N
  557.  Line 20 - Reserved until version 3.0 - MUST be set to N
  558.  Line 21 - Reserved until version 3.0 - MUST be set to N
  559.  Line 22 - Name of your BBS, for display on entry
  560.  Line 23 - Registration number
  561.  
  562.  The first 6 lines are self-explanatory.  2ACT must know where to locate
  563.  all access PCBoard files.  It is allowed to use the same files for
  564.  both first and second accounts if so required.
  565.  
  566.  Line 11 - this is written to the BAT file that loads the second PCBoard
  567.            account, and would normally be just:  c:\pcb\pcb145
  568.            It is included only so you have the option of placing any
  569.            switches required by you on this line
  570.            Note: Do NOT place any modem control switches (C:##, ERR)
  571.            or an error will occur
  572.  
  573.  
  574.  Line 12 - most likely, c:\pcb\second\2act.nam - where all User info
  575.            required to access Second Account is stored
  576.  
  577.  Line 13 - LOCK line - MUST be N, Y or ALL
  578.            This allows turning on/off the flag placed in the .NAM file
  579.            to lock-out a User from being effective - and the method of
  580.            handling New Users not listed in the .NAM file.  It is also
  581.            important when running 2ACTCVT.EXE and 2ACTADD.EXE - please
  582.            see the references under those headings.
  583.  
  584.     Set to Y:
  585.      LOCK parameter in use - The LOCK flag of the .NAM file will be
  586.      checked for all Users before allowing access.  If the User flag
  587.      in .NAM is set to Y, the User is exited, with no explanation.
  588.      If the User flag is set to N, the User is not locked out, and
  589.      PCB2ACT allows the second account to be loaded.
  590.  
  591.     Set to N:
  592.      LOCK parameter is disabled, all Users have access based on
  593.      other parameters set, even if they are flagged as LOCKed
  594.  
  595.     Set to ALL:
  596.      If set to ALL, every User is assumed to be LOCKed out of the
  597.      second account, unless they already have a valid entry (without
  598.      the LOCK set to Y) in the .NAM file.
  599.      If set to ALL, it is assumed a relatively small number of users
  600.      have access to the Second Account (or Sysop maintenance would be
  601.      a lot of work!), so the .NAM file is searched BEFORE sending the
  602.      notice to the User that the Second Account is loading.  If no
  603.      entry exists for the User, Second Account exits with no message.
  604.      It is suggested you alter the PCBTEXT file (Record 549) no say
  605.      nothing to the User if you use the ALL feature.  Then the User
  606.      will get no display whatsoever of the attempt to load the Second
  607.      Account if he has not previously been given access.
  608.  
  609.  Line 14 - if a User is LOCKed out, either because of Line 13 being
  610.            set to ALL, or his LOCK flag set by the Sysop in 2ACT.NAM,
  611.            this file will be displayed to the User.
  612.            Note: placing any single character (preferably N) in this
  613.            line means NO message will be displayed
  614.  
  615.  
  616.  Line 15 - ALLOW line - MUSt be set to Y, N or ALL
  617.           This controls how Users are handled, generally New Users into
  618.           the Second Account.
  619.      Set to N:
  620.       Flag which can be set by the Sysop in 2ACT.NAM is ignored entirely
  621.  
  622.      Set to Y:
  623.       Only Users with the ALLOW flag set to Y in the 2ACT.NAM file are
  624.      allowed in.  This does not stop anyone with no record from entry.
  625.      New Users placed with an N in their ALLOW flag.
  626.  
  627.      Set to ALL:
  628.       Same as Y, but, when 2ACTADD places a New User, this will set the
  629.      Users ALLOW flag to Y.
  630.  
  631.  Line 16 - if a User is not ALLOWed, by his ALLOW flag, this file will
  632.            be displayed to the User.
  633.            Note: placing any single character (preferably N) in this
  634.            line means NO message will be displayed
  635.  
  636.  Lines 17 to 21 are currently reserved, and portions of their parameters
  637.  are already included in the version 2.0.  These lines MUST be set to N
  638.  at this time, or unpredictable actions may occur.  These lines will
  639.  be used to control additional functions of time control, maintenance,
  640.  and files display in the future.
  641.  
  642.  Line 22 - your BBS name as you wish it to appear upon Second Account
  643.            entry
  644.  
  645.  Line 23 - registration number for your BBS only
  646.            Placing any value other than one assigned to you will result
  647.            in it being ignored
  648.  
  649.  
  650. 2ACTADD.EXE
  651.  
  652.    This MUST be run to add a User to the 2ACT.NAM file.  Usually
  653.    called from the same BAT file that called the second account, it
  654.    will read the last User record of the second account USERS file
  655.    and check for an entry of that User in the 2ACT.NAM.  If no
  656.    entry exists, the new entry is made.  The LOCK flag will not be set,
  657.    and the ALLOW flag will be set based upon the parameters the Sysop
  658.    placed in the ALLOW line of the 2ACT.CFG.
  659.  
  660.    The Sysop can choose to enter any User with 2ACTSM instead, but most
  661.    likely, with the possiblities covered for New Users via the flags
  662.    specified in the 2ACT.CFG, this program will be able to handle the
  663.    situation you have common to your BBS.
  664.  
  665. NOGOOD
  666.   This file is built when 2ACT is unable to decide how to handle
  667.   a user for some reason, and exits back to the first account.  It
  668.   is written only in case the Sysop has a reason to check at another
  669.   level for access to the second account.  It can be checked for in
  670.   the BAT file if the Sysop requires it for other use.
  671.  
  672.   This filename can be changed to whatever you require by entry in
  673.   the 2ACT.CFG file.
  674.  
  675. NEWGUY
  676.   This file is built when no account if found for the user in the
  677.   2ACT.NAM file.  Its existence means the user will not have a
  678.   PCBOARD.SYS file written for him, and must enter the second account
  679.   as a New User.  If you choose, this can be used to call other
  680.   programs you may need to run.  It is expected you will use a check
  681.   for this file to run the 2ACTADD.EXE to place the users alias in
  682.   the 2ACT.NAM file when he exits the second account.
  683.   If you choose not to use it for that purpose, remember the user
  684.   will again register in the second account the next time he tries
  685.   if no entry is made.  I do not suggest ignoring NEWGUY.
  686.  
  687. 2ACTCVT.EXE
  688.  
  689.   This utility is provided for anyone previously having been using the
  690.   old version of 2ACT which read User information from the Sysop
  691.   maintained Comment 2 of the USERS file.  Based upon the 2ACT.CFG
  692.   file, it will construct the 2ACT.NAM file with what should be
  693.   acceptable for your use.
  694.   This program will write the first 3 records of the 2ACT.NAM file as
  695.   names of a series of "X"s.  Those fields are reserved for a future
  696.   release of the 2ACTSM maintenance program.
  697.  
  698.  
  699. Board Files:
  700.  
  701.     When you set up the second account, it is assumed you have created
  702.  separate sub-directory for that account, and certain files in there
  703.  are not shared with the first account.  All other files should be the
  704.  same as the first account.  Some suggestions are shown elsewhere in
  705.  this documentation.
  706.  
  707.     It is suggested you make several changes to your PCBTEXT file to
  708.  be used in the Second Account - such as a change to the initial logon
  709.  for a New User of the Second Account to insure he is prompted for an
  710.  alias; also, it is a good idea to change the Main Command prompt to
  711.  add a word to let the User realize he is in the Second Account; I made
  712.  a few more changes - please review the enclosed version for ideas.
  713.  
  714.     The BRDM file normally used for the Main Menu should have one major
  715.  change.  Unless you chose to add a couple lines in the calling BAT
  716.  file to remove the "good" PCBoard.sys written by the first account and
  717.  force the User to exit the system after leaving the second account, he
  718.  will be returned to the first account upon entering a G.  The menu
  719.  should reflect this (noticeably!) as "(G)o back to Main Board" in some
  720.  manner.
  721.  
  722.    The you may wish to use a different TCAN file on the second account,
  723.  as you may be more lenient (or strict) on that account.
  724.  
  725.    The PCBoard CALLERS file defined by Sysop in the .CFG file will log
  726.  all important, or strange occurrences.  This includes all new User
  727.  access, all errors, and all maintenance changes.
  728.  
  729.     For files, if you have different files areas in the 2 accounts, you
  730.  may wish to use a different Download.txt file for the second account,
  731.  as this may greatly speed up searches (Prowho), and give more accurate
  732.  figures if you use a utility that posts activities of the BBS.
  733.  
  734.     If you wish to allow Users to leave the BBS from the Second Account
  735.  it is best to create a Door called OFF.  If you have made the other
  736.  changes to PCBTEXT and the BRDM, it will appear to be a command
  737.  to the USers labelled OFF - just include it in the BRDM and then
  738.  define it in the Doors.lst file.
  739.  
  740.  
  741. OFF
  742.   This will be copied to the Doors.bat by PCBoard when invoked by the User,
  743.  and its only purpose is to copy the PCBSYS.HLD to BOTH the first and
  744.  seond account PCBoard.sys files.  You may wish to reconsider allowing
  745.  this however, as it may not serve your purpose at this time.  If you
  746.  chose to run the time in the Second Account concurrent with the time
  747.  in the first account, the User logging off using OFF will NOT get his
  748.  USERS record updated with that Second Account time subtraction.
  749.  
  750.  copy pcbsys.hld pcboard.sys
  751.  copy pcbsys.hld \pcb\pcboard.sys
  752.  cd\pcb
  753.  board
  754.  
  755.  
  756.  Errors:
  757.  
  758.    The 3 potential errors are either that the BRUN45.EXE cannot be
  759.  located in the path, the 2ACT.CFG file is missing a needed line,
  760.  or 2ACT cannot find a file listed in 2ACT.CFG because of a typo.
  761.  Be sure the filenames in the 2ACT.CFG are the same filenames
  762.  defined in your PCBSetup for the PCBoard.sys, Users, and Pwrd files.
  763.  
  764.    In the event of an error that 2ACT cannot handle, NOGOOD is
  765.  created, and the User returned to the first account.
  766.    The most common reason for this is the Sysop removing the User from
  767.  the USERS file of the Second Account, but fails to delete the User
  768.  from the 2ACT.NAM file.  This causes no problem, but the User will
  769.  not understand what has happened.
  770.  
  771.  
  772. Maintenance:
  773.  
  774.    Presently, maintenance is done using 2ACTSM.EXE and no checking of
  775.  who is accessing it is used.  DOORWAY is required for maintenance
  776.  online.  The 2ACTSM allows you to perform all possibly required
  777.  functions upon the 2ACT.NAM file holding the names and flags of the
  778.  users for the Second Account of the 2ACT.CFG file being processed.
  779.    2ACTSM must be called from within the sub-directory holding the
  780.  2ACT.CFG of the Second Account to be managed.
  781.    All edit and flag toggle functions are written immediately to the
  782.  2ACT.NAM file, not upon exiting the program.
  783.  
  784.    Important Note:  The first 3 entries of the 2ACT.NAM should NOT be
  785.  altered.  They are presently not used by 2ACTSM, but will be in the
  786.  future to allow online management to 3 users, and those records cannot
  787.  get in to the Second Account if those records are used for that
  788.  purpose.  Prior to accessing 2ACT, 2ACTSM MUST be run to properly
  789.  initialize the 2ACT.NAM file!
  790.  
  791.  Available commands for maintenance:
  792.  
  793.   (A)llow flag toggle
  794.         This will reverse the current ALLOW flag setting of the
  795.         current User record displayed
  796.  
  797.   (D)elete current User
  798.         This will blank the "First Account Name", removing the
  799.         current user from access.  It does not release the
  800.         "Second Account Name".  If (P)ack is not used after
  801.         deleting an account, the "Second Account Name" cannot
  802.         be reassigned by 2ACTADD if a New User entering Second
  803.         Account chooses to use that name.  2ACT would treat any
  804.         User later logging in with that Second Account name as
  805.         a New User, and they would be forced to log on using
  806.         all the normal PCBoard prompts when accessing the
  807.         Second Account.
  808.  
  809.  
  810.   (E)dit current User
  811.         This makes the current record available for change, and
  812.         you are prompted to change the First and Second Account
  813.         names.
  814.  
  815.         The "Second Account Name" must have an entry, or the NOGOOD
  816.         file will be created when the User enters, and no Second
  817.         Account access will be available.
  818.  
  819.         The LOCK and ALLOW flags will always be either Y or N.
  820.         Use the A and L toggles to alter these entries.
  821.  
  822.   (F)ind Second Account name
  823.         Search for User record by "Second Account Name"
  824.  
  825.   (L)ock flag toggle
  826.         This will reverse the current LOCK flag setting of the
  827.         current User record displayed
  828.  
  829.   (N)ew User entry
  830.         Lets Sysop create a new record, and prompts for
  831.         first & second account names, and LOCK & ALLOW flag types.
  832.  
  833.   (P)ack file
  834.         Used to remove all deleted Users, it will create a 2ACT.BAK
  835.         and rewrite the 2ACT.NAM minus deleted Users
  836.  
  837.   (Q)uit
  838.         Exits the program
  839.  
  840.   (S)earch for First Account Name
  841.         Search for User record by "First Account Name"
  842.  
  843.  
  844.   (X)pert menu toggle
  845.        Toggles the you between a full menu of commands available
  846.        and a single line prompt
  847.  
  848.   (##) locate record number ##
  849.        Displays the record number entered.  Entering a non-existing
  850.        record number results in the first available record being
  851.        displayed.
  852.  
  853.  
  854.   (O)utput list to printer
  855.         Prints all records to the standard printer defined in the
  856.         2ACT.CFG.
  857.  
  858.   (P)ack 2ACT.NAM file
  859.         This is used to delete empty records, and can speed access
  860.         if many empty records exist.
  861.  
  862.   (S)econd account name search
  863.         Search for User record by "Second Account Name"
  864.   (X)pert menu toggle
  865.         Toggles you between full menu, and a single line prompt.
  866.   (#) find record number
  867.         Entering any number places you at that record number, but,
  868.         will place you at record 1 if an invalid number entered
  869.  
  870.  
  871. Applications:
  872.  
  873.  The following will show the combined effect of the LOCK and ALLOW
  874.  flags in the 2ACT.CFG and each User's LOCK and ALLOW flags.
  875.  
  876.  In all cases shown, it is assumed the Sysop has messages defined
  877.  for LOCKed out and NOT ALLOWED Users.  Leaving a single character
  878.  for either of these message filenames within the 2ACT.CFG will
  879.  result in no message file display in that case.  In the unregistered
  880.  version, a message must be available in either case.
  881.  
  882.  In the following the "*" shows treatment of New User by 2ACTADD.
  883.  
  884.  2ACT.CFG set as:    with 2ACT.NAM check result being:
  885.  
  886.  LOCK=N, ALLOW=ALL     New User w/o record - New User allowed,
  887.                        User entry should be placed in BAT file by
  888.  Used to allow any     check of NEWGUY with 2ACTADD.EXE
  889.  User in without
  890.  any checks by the   * New User will be entered with flags of:
  891.  Sysop/Co-Sysop        LOCK=N and ALLOW=Y
  892.  required.
  893.                        User w/LOCK=Y or w/LOCK=N - LOCK ignored
  894.  
  895.                        w/ALLOW=N - User displayed NOT ALLOWED
  896.                        message, returned to first account
  897.                        w/ALLOW=Y - normal access to account
  898.  
  899.  LOCK=N, ALLOW=Y       New User w/o record - New User allowed
  900.                        to enter, but, it is assumed he is to be
  901.                        assigned a level by PCBoard that doesn't
  902.                        allow any privileges
  903.  
  904.                        User entry should be placed in BAT file by
  905.   Used to let Users    check of NEWGUY with 2ACTADD.EXE
  906.  register, but needs
  907.  Sysop/Co-Sysop      * New User will be entered with flags of:
  908.  to set ALLOW flag     LOCK=N and ALLOW=N
  909.  
  910.                        User w/LOCK=Y or w/LOCK=N - LOCK ignored
  911.                        w/ALLOW=N - User displayed NOT ALLOWED
  912.                        message, returned to first account
  913.                        w/ALLOW=Y - normal access to account
  914.  
  915.  
  916.  LOCK=N, ALLOW=N       New User w/o record - New User allowed
  917.                        User entry should be placed in BAT file by
  918.                        check of NEWGUY with 2ACTADD.EXE
  919.  
  920.                      * New User will be entered with flags of:
  921.                        LOCK=N and ALLOW=Y by 2ACTADD.EXE
  922.  
  923.                        User w/LOCK=Y or w/LOCK=N - LOCK ignored
  924.                        User w/ALLOW=Y or w/ALLOW=N - ALLOW ignored
  925.                        User w/record is allowed normal account access
  926.  
  927.  LOCK=Y, ALLOW=ALL     New User w/o record - New User allowed,
  928.                        User entry should be placed in BAT file by
  929.                        check of NEWGUY with 2ACTADD.EXE
  930.  
  931.                      * New User will be entered with flags of:
  932.                        LOCK=N and ALLOW=Y by 2ACTADD.EXE
  933.  
  934.                        w/LOCK=Y - User displayed LOCKED OUT message
  935.                        and returned to first account
  936.  
  937.                        User w/LOCK=N and:
  938.                        w/ALLOW=N - User displayed NOT ALLOWED
  939.                        message, returned to first account
  940.                        w/ALLOW=Y - normal access to account
  941.  
  942.  LOCK=Y, ALLOW=Y       New User w/o record - New User allowed,
  943.                        User entry should be placed in BAT file by
  944.                        check of NEWGUY with 2ACTADD.EXE
  945.  
  946.                      * New User gets no entry in 2ACT.NAM
  947.  
  948.                        w/LOCK=Y - User displayed LOCKED OUT message
  949.                        and returned to first account
  950.  
  951.                        User w/LOCK=N and:
  952.                        w/ALLOW=N - User displayed NOT ALLOWED
  953.                        message, returned to first account
  954.                        w/ALLOW=Y - normal access to account
  955.  
  956.  LOCK=Y, ALLOW=N       New User w/o record - New User allowed,
  957.                        User entry should be placed in BAT file by
  958.                        check of NEWGUY with 2ACTADD.EXE
  959.  
  960.                      * New User gets no entry in 2ACT.NAM
  961.  
  962.                        w/LOCK=Y - User displayed LOCKED OUT message
  963.                        and returned to first account
  964.  
  965.                        User w/LOCK=N and:
  966.                        User w/ALLOW=Y or w/ALLOW=N - ALLOW ignored
  967.                        User w/record is allowed normal account access
  968.  
  969.  
  970.  All formats with LOCK=ALL prevent any access from any User not
  971.  entered by the Sysop.  Combined with the PCBText change, and the
  972.  intentional non-mention of the Door in the DOORS file, the USer
  973.  is returned to the first account within seconds of entering the
  974.  command to load the door with no expalanation.  It is suggested
  975.  that the Sysop may choose to make the LOCKED.MSG read simply:
  976.   (2ACT) is a Bad Command - Need (H)elp?
  977.  which will effectively make any unregistered User feel the 2ACT
  978.  does nothing.
  979.  
  980.  LOCK=ALL, ALLOW=ALL   New User w/o record - New User is returned
  981.                        to first account, displayed LOCKED.MSG
  982.                        If no LOCKED.MSG exists, the User sees nothing
  983.                        in the registered version
  984.  
  985.                      * 2ACTADD should not be run for New Users, but
  986.                        if run assigns LOCK=Y and ALLOW=Y
  987.   This configuration
  988.   is used to not       User w/LOCK=Y - User displayed LOCKED OUT message
  989.   allow any New        and returned to first account
  990.   Users except via
  991.   Sysop entry - it     User with LOCK=N and:
  992.   literally "hides"    w/ALLOW=N - User displayed NOT ALLOWED message
  993.   the sub-board.       and returned to first account
  994.                        w/ALLOW=Y - normal access to account
  995.  
  996.  LOCK=ALL, ALLOW=Y     New User w/o record - New User is returned
  997.                        to first account, displayed LOCKED.MSG
  998.                        If no LOCKED.MSG exists, the User sees nothing
  999.                        in the registered version
  1000.  
  1001.                      * 2ACTADD should not be run for New Users, but
  1002.                        if run assigns LOCK=Y and ALLOW=N
  1003.   This configuration
  1004.   is used to not       w/LOCK=Y - User displayed LOCKED OUT message
  1005.   allow any New        and returned to first account
  1006.   Users except via
  1007.   Sysop entry - it     User with LOCK=N and:
  1008.   literally "hides"    w/ALLOW=N - User displayed NOT ALLOWED
  1009.   the sub-board.       message, returned to first account
  1010.   Same as above.       w/ALLOW=Y - normal access to account
  1011.  
  1012.  LOCK=ALL, ALLOW=N     New User w/o record - New User is returned
  1013.                        to first account, displayed LOCKED.MSG
  1014.                        If no LOCKED.MSG exists, the User sees nothing
  1015.                        in the registered version
  1016.  
  1017.                      * 2ACTADD should not be run for New Users, but
  1018.                        if run assigns LOCK=Y and ALLOW=Y
  1019.   This configuration
  1020.   is used to not       w/LOCK=Y - User displayed LOCKED OUT message
  1021.   allow any New        and returned to first account
  1022.   Users except via
  1023.   Sysop entry - it     User with LOCK=N and:
  1024.   literally "hides"    User w/ALLOW=Y or w/ALLOW=N - ALLOW ignored
  1025.   the sub-board.       User w/record is allowed normal account access
  1026.   Same as above, but
  1027.   no ALLOW function.
  1028.